Bibliothek oder Passwort-geschützte Bibliothek erzeugen und prüfen

So erstellen Sie eine Bibliothek:

  1. Wählen Sie die Bibliothekskonfiguration aus, auf deren Basis Sie die Bibliothek erstellen wollen.

  2. Empfohlen für eine Neuron Power Engineer-Bibliothek: Validieren Sie die Bibliothek auf Basis der Bibliothekskonfiguration.
    (Info) Neuron empfiehlt Ihnen, die bibliotheksbezogene Validierung für eine Neuron Power Engineer-Bibliothek selbst zu starten, da die bibliotheksbezogene Validierung einer OEM-product-Bibliothek aus Performance-Gründen nicht in allen Varianten von Neuron Power Engineer automatisch gestartet wird. Im Gegensatz dazu wird bei der Erzeugung einer logi.SAFE- oder logi.WEB-Bibliothek die bibliotheksbezogene Validierung automatisch gestartet.

  3. Für die Erzeugung und Prüfung der Bibliothek (= für die automatische Validierung) wählen Sie eine dieser Möglichkeiten:

    1. den Befehl Bibliothek erzeugen im Kontextmenü der Bibliothekskonfiguration

    2. den Befehl Erzeugen im Kontextmenü der zu erzeugenden Bibliothek (die Bibliothek ist als Unterebene der aufgeklappten Bibliothekskonfiguration im Projektexplorer sichtbar)

    3. den Befehl Erzeugen (Passwort-geschützt)... im Kontextmenü der zu erzeugenden Bibliothek
      (Info) Mit dieser Möglichkeit können Sie die Sourcen der Bibliothekselemente zusätzlich in einer passwort-geschützten Bibliothek bereitstellen. Siehe "Sourcen in einer passwort-geschützten Bibliothek bereitstellen" über die Unterschiede der Erzeugungsmöglichkeiten.

  4. Stellen Sie sicher, dass die Bibliothek korrekt erstellt wurde:

    1. Stellen Sie anhand der Meldungen in der Sicht Fehlerprokokoll sicher, dass die Bibliothek erstellt wurde.

    2. Sofern die Validierung durch Sie selbst oder automatisch gestartet wurde: Stellen Sie anhand der Meldungen in der Sicht Validieren: Objektname sicher, dass keine Regelverletzungen entdeckt wurden. Falls doch, beheben Sie diese Regelverletzungen und validieren/erzeugen Sie die Bibliothek erneut.

    3. Sofern in Ihrer Variante von Neuron Power Engineer der Bibliothekerzeugungs-Bericht erzeugt wird, können Sie anhand dieses Berichts sicherstellen, dass die Bibliothek mit den korrekten Bibliothekselementen erstellt wurde.

Beachten Sie: Ältere Dateien der Bibliothek (mit dem gleichen Namen und der gleichen Version) werden automatisch gelöscht. Dieses Löschen erfolgt auch, falls die neue Datei nicht erzeugt werden konnte. Neuron empfiehlt daher, die Versionsnummer in der Bibliothekskonfiguration vor jedem Erzeugen einer Bibliothek zu ändern.

 

Gut zu wissen

(Graue Glühbirne) Neuron Power Engineer stellt ein Werkzeug für das automatisierte Erzeugen, Bereitstellen und Verifizieren der Bibliothek zur Verfügung.

Ablage der Bibliothek und anderer Dateien

Neuron Power Engineer erzeugt:

  • die Bibliothek im Unterordner target des Projekts

  • den Bericht für die Validierungsprüfung im gleichen Ordner wie die Bibliothekskonfiguration
    Details zum Bericht: Siehe unter "Ergebnisse der Prüfung in Sicht "Validieren".

  • den Bibliothekerzeugungs-Bericht (im HTML- als auch im XML-Format) im Unterordner target des Projekts – mit dem Namen library__version.buildreport.html und library__version.buildreport.xml
    Dieser Bericht enthält Informationen über die Bibliothek, wie z.B. welche Bibliothekselement mit welcher Testabdeckung enthalten sind.  (Info) Die Erzeugung dieses Berichts ist nicht in allen Varianten von Neuron Power Engineer verfügbar.

Gut zu wissen

(Graue Glühbirne) Standardmäßig wird der Ordner target nicht im Projektexplorer angezeigt. So können Sie den Ordner target im Projektexplorer anzeigen lassen: Klicken Sie auf in der Symbolleiste des Projektexplorers und wählen Sie Filter und Anpassungen.... Im Dialog entfernen Sie die Markierung bei target Ordner (unter Filter) und drücken Sie OK.

(Graue Glühbirne)Mit Hilfe von Dateien, die für die Bibliothek zusätzlich erzeugt wurden, und einem Kommandozeilen-Werkzeug kann ein Administrator nachweisen, dass die Bibliothek seit ihrer Erzeugung verändert wurde oder nicht. Kontaktieren Sie Neuron, falls Sie mehr Informationen zu dieser Möglichkeit haben wollen.

Inhalt der Bibliothek

Der Inhalt wird laut den Spezifikationen der Bibliothekskonfiguration erzeugt. Die Bibliothekskonfiguration selbst wird ebenfalls in die Bibliothek kopiert.
Dabei erzeugt Neuron Power Engineer möglicherweise Dateien mit Dateierweiterung .iecst (statt der Dateien mit der ursprünglichen Dateierweiterung, wie z.B. .iecfbd), sofern der Wert INTERFACE oder OBJECT beim Schlüsselwort DEPLOY für die jeweilige POE (z.B. die FBS-POE) spezifiziert wurde. Mehr Informationen darüber und über den weiteren Inhalt der Bibliothek (z.B. automatisch erstellte Ordner) finden Sie in einem der folgenden Artikeln:

Troubleshooting: Probleme beim Erzeugen einer logi.SAFE- und logi.WEB-Bibliothek analysieren

Falls Sie fehlerhafte →Vendor-Bausteine in einer logi.SAFE- oder logi.WEB-Bibliothek verwenden, schlägt das Erzeugen der Bibliothek fehl. Üblicherweise enthält die Datei compile_result.txt entsprechende Fehlermeldungen, die bei der Analyse des Fehlers weiterhelfen.
(Info) Standardmäßig wird die Datei compile_result.txt nicht im Projektexplorer angezeigt.  Lesen Sie unter "Anwendung kann nicht erstellt oder geladen werden" nach, wie Sie die Datei in Neuron Power Engineer anzeigen lassen.

Falls die Datei compile_result.txt jedoch keine aussagekräftige Meldung enthält, aktivieren Sie am besten so den "Development Mode" für das Erzeugen der Bibliothek:

  1. Beenden Sie Neuron Power Engineer.

  2. Gehen Sie zum Ordner, in dem Sie Neuron Power Engineer installiert haben.

  3. Suchen Sie die Datei NeuronPowerEngineer.ini und öffnen Sie diese in einem Texteditor.

  4. Tragen Sie -Dlc3.logisafe.devmod am Ende der Datei ein und vergeben Sie den Wert true.

  5. Beispiel
    ...
    -Dlc3.logisafe.devmod=true
  6. Speichern Sie die Datei.

  7. Starten Sie Neuron Power Engineer.

  8. Erzeugen Sie die logi.SAFE- oder logi.WEB-Bibliothek erneut.
    (Warnung) Diese Bibliothek ist nicht für den Einsatz geeignet, da die nachfolgenden, erforderlichen PiL-Tests für diese Bibliothek fehlschlagen werden.

Prüfen Sie nun den Inhalt der Datei compile_result.txt auf aussagekräftigere Fehlermeldungen und korrigieren Sie den Vendor-Baustein entsprechend.

Nach der Korrektur des Fehlers beenden Sie Neuron Power Engineer erneut, deaktivieren Sie den "Development Mode" (indem Sie -Dlc3.logisafe.devmod aus der Datei löschen) und erzeugen Sie dann logi.SAFE- oder logi.WEB-Bibliothek erneut.